M2 - MailTo
by bunkahumpa
bunkahumpa@playcs.com

Installation:

- Unzip ALL of the files (including this readme) into your main mIRC directory. If you do not, the script will not work correctly (it will give you a message telling you to unzip all of the files when you load it).
- Run mIRC and type /load -rs mailto.mrc
- Click yes


TABLE OF CONTENTS:
- Notes
- What is M2?
- What is SMTP?
- How do I get my SMTP server?
- How do I save my default e-mail address and SMTP server?
- How do I save or load a draft?
- How can I access my address book?
- How can I enter an address from my address book into my e-mail?
- What is a signature?
- How can I send an attachment?
- Can I check my e-mail with M2?
- How can I send e-mail in my own script?
Notes:
This script uses MDX by DragonZap.

What is M2?
MailTo is a SMTP client that allows you to send an e-mail to any address. You can save and load e-mail drafts, save your default e-mail address, SMTP server, your own custom signature, as well as save e-mail addresses in an address book which you can use to insert an e-mail address into an e-mail easily. Also, I created an easy to use alias for mIRC scripters to send e-mail with one line of code!

What is SMTP?
SMTP is Simple Mail Transfer Protocol. It's been used since the early 80's and is the way mail is sent from place to place. It required no authentication, so you didn't have to enter an account nor password. Unfortunately, that is not the case now (for the most part). Most SMTP servers now require you to auth to connect to them for their services (I really wanted to implement a way to auth, but I haven't figured out how to do it correctly).

How do I get my SMTP server?
Usually the address to your ISP's SMTP server is provided to you by your ISP when you get an e-mail account. I STRONGLY suggest that you use the one your ISP gave you (if they did give you one in the first place) or if you are at school, use your school's if they have one. I just listed a bunch of SMTP servers below, not sure how helpful this will be though.

Here are some common SMTP servers:

- smtp.comcast.net
- mail.earthlink.net
- smtp.earthlink.net
- mailhost.worldnet.att.net
- mail.bellsouth.net
- mail.flashcom.net
- mail.nc.freei.net
- smtp1.ibm.net
- mail.interpath.net
- smtp.intetech.com
- smtp.intrex.net
- smtp.ipass.net
- mailrelay.mciworldcom.net
- mail.mindspring.com
- smtp.email.msn.com
- smtp.netzero.net
- smtp-server.nc.rr.com
- smtp.tes-tech.net
- smtp.hotpop.com
- smtp.namestoday.ws
- smtp.blueyonder.co.uk
- smtp.businessserve.co.uk
- smtp.btclick.com
- mail.btinternet.com
- mail.btopenworld.com
- smtp.blueyonder.co.uk
- relay.clara.net
- smtp.ntlworld.com
- post.demon.co.uk
- smtp.easynet.co.uk
- smtp.freeserve.co.uk
- mail.genie.co.uk
- smtp.ic24.net
- smtp.domain.ext
- smtp.lineone.net
- smtp.lycos.co.uk
- smtp.madasafish.com
- smtp.mistral.co.uk
- smtp.namestoday.ws
- mailhost.netscapeonline.co.uk
- smtp.nildram.co.uk
- smtp.ntlworld.com
- mail.onetel.net.uk
- smtp.dial.pipex.com
- smtp.purplenet.co.uk
- smtp.supanet.com
- smtp.tiscali.co.uk
- smtp.blueyonder.co.uk
- mail.tesco.net
- smtp.tiscali.co.uk
- mail.totalise.co.uk
- smtp.ukgateway.net
- smtp.v21.co.uk
- smtp.virgin.net
- mail.vispa.com
- smtpmail.waitrose.com
- mail.which.net
- smtp.tiscali.co.uk
- smtp.mail.yahoo.com

How do I save my default e-mail address and SMTP server?
Go to File > Options and enter them in, then save changes.

How do I save or load a draft?
If you want to save a draft for later without sending it, click on "File > Save Draft..." If you want to save the draft AND send it, simply check the box that says "save draft" next to the send button. If you want to load a draft, click on "File > Load Draft..." and find a *.m2 file in your mIRC directory.

How can I access my address book?
Either right-click in mIRC and select M2 Address Book from the popups, select "Address Book" from the menubar on the main dialog, or click on the little "A" buttons near the To/Cc/Bcc fields in the MailTo dialog.

How can I enter an address from my address book into my e-mail?
You can only do this one way, click on one of the "A" buttons on the main dialog and then select an e-mail address from the listbox, then the button will be enabled for you to enter it into the e-mail (it will be entered in the field next to the "A" button you pressed).

What is a signature?
A signature is a set amount of text that goes at the bottom of all of your e-mails. You can enter your own in File > Options and you can also enable/disable it from there. You can easily check if your signature is enabled or not by looking at the main dialog, it will tell you. You will not see your signature in the body editbox, but it sends it automatically if it is enabled.

How can I send an attachment?
On the main dialog near the bottom there is an button labeled "Browse." Click this button and navigate to the file you want to attach and hit ok, the path will appear in the editbox next to it. If you want to delete the attachment and not send it, delete the path from the editbox.

Can I check my e-mail with M2?
No, that would require the usage of another protocol, pop3. M2 is meant to quickly send e-mail messages from mIRC without having to open up a bulky e-mail program or navigate the web to a web-based one.

How can I send e-mail in my own script? (thanks to MadEwokHerd for suggesting this)
I created an alias just for this, it's /scriptmailer. You can see the details at around line 456 of mailto.mrc. You MUST have mailto.mrc loaded in order to use it. Here's the correct format:

/scriptmailer smtp.server.domain FROM TO ^ subject ^ body

For example:

/scriptmailer smtp.comcast.net bunkahumpa@playcs.com bobbyl03@comcast.net ^ test subject ^ testing the body, bye :D

You MUST have the 2 ^'s, they seperate things.
Questions can be sent to me at